home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbs_soft / sfbull13.zip / SFBULLS.DOC < prev    next >
Text File  |  1993-05-16  |  10KB  |  207 lines
  1.  
  2.  
  3.                    T&T Software
  4.                   SFBULLS V1.03
  5.                 (c) Copyright 1993
  6.                    for
  7.                 Spitfire 3.3+ BBS's
  8.  
  9.  
  10. ╔════════════════════════════════════════════════════════════════════════╗
  11. ║  ■ SFBULLS V1.03 Overview & Instructions ■                             ║
  12. ╚════════════════════════════════════════════════════════════════════════╝
  13. ═ Overview ═
  14. Spitfire Bulletin Creator (SFBULLS) is a program designed for Sysops who
  15. would like to make a bulletin of the files uploaded during the month, new
  16. users during the month, daily statistics for the month, downloads, or a
  17. display of the last successful CircuitNet Mail run.  This program
  18. currently supports Spitfire 3.3 and will be quickly updated to work
  19. with later versions of Spitfire as necessary.  SFBULLS will read your
  20. callers.log file to get the information needed to create the bulletins.
  21. A history of releases may be found at the end of this file!
  22.  
  23. ═ Instructions ═
  24. Just unarchive the files into their own directory and make sure you run it
  25. from that directory!  There are two command line parameter that may be used.
  26.  
  27.    SFBULLS SFBULLS.CFG S
  28.        ^^^^^^^     ^
  29.        ^^^^^^^    [S]ort Downloads or [N]o Sort.
  30.        ^^^^^^^
  31.        Configuration Filename
  32.  
  33. If the program is run without one of the parameters then the following
  34. defaults will be used:
  35.        
  36.        Callers log  --->  Current directory (Callers.log).
  37.        Net-Mail log --->  Current directory (Cnact.log).
  38.        Upload files --->  Current directory (Sfups.clr/bbs).
  39.      New user files --->  Current directory (Sfnew.clr/bbs).
  40.    Statistics files --->  Current directory (Sfstats.clr/bbs).
  41.     Downloads files --->  Current directory (Sfdowns.clr/bbs).
  42.      Net-Mail files --->  Current directory (Netmail.clr/bbs).
  43.            Sort --->  [N]o Sort.
  44.        BBS Name --->  [U N K N O W N B B S!].
  45.  
  46. You must use both parameters or none!
  47.  
  48. ╔════════════════════════════════════════════════════════════════════════╗
  49. ║  ■ SFBULLS Necessary Files ■                                           ║
  50. ╚════════════════════════════════════════════════════════════════════════╝
  51.  
  52. Your SFBULL13.arj file should contain the following files:
  53.  
  54.     Sfbulls.exe -> The Executable File.
  55.     Sfbulls.doc -> This Document File.
  56.        Bullsort.exe -> Sorts Download Data File.
  57.        Bullscfg.exe -> Creates Configuration Files.
  58.        Register.txt -> Registration Form.
  59.     File_id.diz -> Short Program Description.
  60.  
  61.     Sfbulls.cfg -> Example Configuration File Made By Bullscfg.exe.
  62.  
  63.        Sfbuldwn.dat -> Files Downloaded Binary Data File.
  64.     Sfbulls.dat -> Last Caller Number Processed.
  65.  
  66.   ** NOTE: The two .dat files are only created when you choose to make a
  67.        downloads bulletin.  To restart the downloads bulletin at the
  68.        beginning of each month just delete both .dat files.  Bullsort.exe
  69.        is called from within Sfbulls.exe to sort Sfbuldwn.dat, therefore,
  70.        ALL .DAT and .EXE files must exist in the same directory and MUST be
  71.        run from that directory.
  72.  
  73. ╔════════════════════════════════════════════════════════════════════════╗
  74. ║  ■ SFBULLS Configuration File ■                                        ║
  75. ╚════════════════════════════════════════════════════════════════════════╝
  76. The Configuration file may be named anything you wish to name it, but it must
  77. be included on the command line for SFBULLS to use it.  Here is the example
  78. configuration file explained:
  79.  
  80. LINE  1: Tim's House Of Fun BBS <-- BBS name (only works in registered version).
  81. LINE  2: c:\sf\work\callers.log <-- Callers.log to get data from
  82. LINE  3: c:\sf\display\bullet1.clr <-- Path+name of Uploads Ansi Display
  83. LINE  4: c:\sf\display\bullet1.bbs <-- Path+name of Uploads Ascii Display
  84. LINE  5: c:\sf\display\bullet2.clr <-- Path+name of New Users Ansi Display
  85. LINE  6: c:\sf\display\bullet2.bbs <-- Path+name of New Users Ascii Display
  86. LINE  7: c:\sf\display\bullet3.clr <-- Path+name of Statistics Ansi Display
  87. LINE  8: c:\sf\display\bullet3.bbs <-- Path+name of Statistics Ascii Display
  88. LINE  9: c:\sf\display\bullet4.clr <-- Path+name of Downloads Ansi Display
  89. LINE 10: c:\sf\display\bullet4.bbs <-- Path+name of Downloads Ascii Display
  90. LINE 11: c:\sf\circuit\cnact.log <-- CircuitNet Activity Log to get data from
  91. LINE 12: c:\sf\display\welcome4.clr <-- Path+name of CircuitNet Ansi Display
  92. LINE 13: c:\sf\display\welcome4.bbs <-- Path+name of CircuitNet Ascii Display
  93.  
  94. Any line above may be substituted with the word NONE to not create that display
  95. screen.
  96.  
  97. To create the configuration file just run Bullscfg.exe with the filename as
  98. a command line parameter or just the program name for the default name of 
  99. Sfbulls.cfg.
  100.  
  101. Example run as event A:
  102.  
  103. :EVENT_A
  104.  cd\sf\sfbulls
  105.  sfbulls sfbulls.cfg s
  106.  cd\sf
  107.  GOTO LOOP
  108.  
  109. Thats all there is to it....Enjoy it.
  110.  
  111. ╔════════════════════════════════════════════════════════════════════════╗
  112. ║  ■ SFBULLS Registration Information ■                                  ║ 
  113. ╚════════════════════════════════════════════════════════════════════════╝
  114. Registration of SFBULLS reflects the concept of Shareware.
  115.  
  116. We decided that we would charge $1.00 for registration of this program.
  117. We feel that is a great price for this program.  We would also like to
  118. go along with Mike Woltz on keep small utilities for Spitfire cheap.
  119.  
  120. Registration brings you:
  121.  
  122. Your own personally compiled copy with the [U N R E G I S T E R E D] replaced
  123. with your name or your BBS's name on the screen. 
  124.  
  125. The Press Any Key to Continue..... is also removed so that the program may be
  126. run as a nightly event.
  127.  
  128.  
  129. ══════════ Please use the File "Register.txt" for Registration ═══════════
  130.  
  131. ╔════════════════════════════════════════════════════════════════════════╗
  132. ║  ■ SFBULLS V1.03 Credits and Many Thanks ■                             ║
  133. ╚════════════════════════════════════════════════════════════════════════╝
  134. Many thanks go to Mike Woltz of Buffalo Creek Software for creating the best
  135. BBS package on the market and the best utilities to go with that package!
  136. Spitfire is copyrighted by Mike Woltz.
  137.  
  138. Without Mike, I wouldn't be writing this little (or for that matter any)
  139. utility for Spitfire!
  140.  
  141. Full support will be given on Tim's House Of Fun BBS, please call we would
  142. like to hear any concerns or comments!
  143.  
  144. ╔════════════════════════════════════════════════════════════════════════╗
  145. ║  ■ SFBULLS Warranty and Disclaimer ■                                   ║
  146. ╚════════════════════════════════════════════════════════════════════════╝
  147.  = Warranty =
  148. This product is provided "as is" without warranty of any kind.  The entire
  149. risk as to the results and performance of the program is assumed by you.
  150. Futhermore, we the authors do not warrant, guarantee, or make any represent-
  151. tions regarding the use of, or the results of the use of the program, and you
  152. rely on the program and results solely at your own risk. We the authors cannot
  153. accept responsibility for system damage, either directly or indirectly from
  154. the use of this product.
  155.  
  156.  = Disclaimer =
  157. The Authors of this program, Tim's House Of Fun BBS and its Co-sysops 
  158. are in no way responsible for any damages sustained either directly
  159. or indirectly from the use of SFBULLS.  Also if the file has been
  160. modified in any way we will take no responsibility for it's use Whatsoever!
  161. The .EXE file has been tested on several machines, from 286's to 486's and
  162. worked perfectly on all. If you should have any problems with this file
  163. please call Tim's House Of Fun BBS to obtain a good copy.
  164.  
  165.  
  166.          Please forward any comments or suggestions to:
  167.  
  168. Timothy J. Ward                                   Tim's House Of Fun BBS
  169. 398 Trefoil Place              or                      Waldorf, MD
  170. Waldorf, MD 20601                                     (301) 705-7115
  171.                           300-14.4bps (v.32bis)
  172.                            CircuitNet Node Id = 301000
  173.  
  174. Know this program is not bug free, if you happen to find a bug, please let me
  175. know right away so that I can SQUASH IT!!
  176.  
  177. ╔════════════════════════════════════════════════════════════════════════╗
  178. ║  ■ SFBULLS History ■                                                   ║
  179. ╚════════════════════════════════════════════════════════════════════════╝
  180. ===============================================================================
  181. Version Number |       What Changed in this Version?                |   Date
  182. ===============================================================================
  183. Version 1.03 - | Added Messages Sent to the CircuitNet Screen as    | *5/13/93*
  184.            | well as the Version Number is Displayed Now.       |
  185.            | Changed from Month to XX-XX-XX to XX-XX-XX format  |
  186.            | on New Users and Statistics Bulletins.             |
  187.                | To Convert from 1.02:                              |
  188.            | Simply Replace the Old Sfbulls.exe with the New!   |
  189.                | Add the new two lines to the config. file........  |
  190.                |                                                    |
  191.                | Changed Month on downloads bulletin to the format  |
  192.                | xx-xx-xx, so it says Downloads thru xx-xx-xx! where|
  193.                | xx-xx-xx is the date the last caller called.       |
  194.                |                                                    |
  195.            | Find Caller in Callers.log equal to that of the    |              
  196.            | one saved in sfbulls.dat instead of greater than!  |
  197.            | (Only process downloads after the callers number   |
  198.            | saved is found in the callers.log                  |
  199. ---------------|----------------------------------------------------|----------
  200. Version 1.02 - | At the request of Charles Horsey added an option   | *5/10/93*
  201.            | to create a bulletin of downloads.                 |
  202. ---------------|----------------------------------------------------|----------
  203. Version 1.01 - | Added support for CircuitNet Display Screen        | *5/10/93*
  204. ---------------|----------------------------------------------------|----------                       
  205. Version 1.00 - | Initial Release, no bugs known at time of release! | *4/29/93*
  206. -------------------------------------------------------------------------------
  207.